home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / business / pb063.dms / pb063.adf / PayAdvice.Doc < prev    next >
Text File  |  1994-10-20  |  44KB  |  1,123 lines

  1.  
  2.  
  3.                             Pay Advice Analyser V4.2
  4.  
  5.  
  6.                         Original idea...     Robert Hart
  7.  
  8.                         Design...        Richard Smedley
  9.                                            Andy Eskelson
  10.  
  11.                         Programming...   Richard Smedley
  12.  
  13.  
  14.                        Copyright (C) Richard Smedley 1994
  15.                                All Rights Reserved
  16.  
  17.  
  18.                               Freely  distributable
  19.  
  20.  
  21.  
  22.  
  23.  
  24. INTRODUCTION
  25. ============
  26.  
  27. A friend of mine once explained to me about how much he hated having to
  28. keep several old cardboard boxes in the bottom of his wardrobe, each of
  29. which he was slowly-but-surely filling with the Pay Advice slips that he
  30. receives in his wage packet.
  31.  
  32. He asked me if I knew of any way to transfer all his wage details onto his
  33. trusty Amiga, thus allowing him to throw out his dusty collection of pay
  34. slips and yet retain a permanent record of all his earnings. Much to his
  35. disappointment, I explained to him that unless he wanted to try using a
  36. spreadsheet then there wasn't really any realistic solution.
  37.  
  38. Sadly this idea just didn't work out. My friend had been thinking more
  39. along the lines of a simple, easy-to-use database program on which he could
  40. enter all his wage details without any awkward setting up or fiddling about.
  41.  
  42. After spending many sleepless nights sitting in front of the computer, I
  43. triumphantly produced a solution...
  44.  
  45.  
  46.  
  47.  
  48.  
  49. WHY BOTHER USING THIS PROGRAM?
  50. ==============================
  51.  
  52. Actually, there are a number of reasons for keeping a record of your wage
  53. details on your computer. The most obvious, of course, is that you'll
  54. finally be able to throw out all your old pay slips and yet still retain a
  55. permanent record of their contents.
  56.  
  57. More importantly than this, though, it is advisable to keep a regular check
  58. on your wages and how much tax your paying, to make sure that the tax man
  59. (or, worse still, your employer) isn't fiddling you. Of course, when you
  60. want to check your tax, you could always start sifting through boxes upon
  61. boxes of paperwork while you try to locate the required pay slips, but it
  62. is far quicker, easier, and more convenient to simply use the computer to
  63. find those details for you.
  64.  
  65. Additionally, even if you're only slightly curious about just how large a
  66. slice of your hard earned cash ends up in the hands of the tax man, then
  67. this in itself is a good reason for keeping a computerised record of your
  68. wage details. It might surprise you to see just how all those "little"
  69. deductions start piling up into something far more serious as you get
  70. further into the year...
  71.  
  72. And, as an extra bonus, there is the added advantage that all your wage
  73. details will be securely locked away on the computer where prying eyes and
  74. inquisitive fingers can't get at them.
  75.  
  76.  
  77.  
  78.  
  79.  
  80. PAYING THE SHAREWARE FEE
  81. ========================
  82.  
  83. This program is shareware. If you like and/or use it then please register
  84. by sending FIVE (UK) POUNDS STERLING to this address:
  85.  
  86.                               Richard Smedley
  87.                               257 Stoneyford Road
  88.                               Sutton-In-Ashfield
  89.                               Notts.
  90.                               NG17 3GJ
  91.                               England
  92.  
  93. Everybody who registers will receive a copy of the complete program, with
  94. the enabled save functions.
  95.  
  96. Registered users of previous versions can obtain a free update by sending
  97. a blank disk plus suitable stamped addressed envelope to this address.
  98.  
  99.  
  100.  
  101.  
  102.  
  103. HARD DRIVE INSTALLATION
  104. =======================
  105.  
  106. To install this program on a hard drive, simply create a drawer entitled
  107. "PayAdvice" (without the quotes!) in your boot partition, and then use the
  108. mouse to drag the PayAdvice program icon into that drawer.
  109.  
  110. Next, load your s:Startup-Sequence (or s:User-startup if you're using
  111. Kickstart 2.0 or greater) into a text editor and add the line:
  112.  
  113.                        Assign PayAdvice: SYS:PayAdvice/
  114.  
  115. Finally, if you've saved any program and/or printer preferences from within
  116. the Pay Advice program then open the Shell window, insert your Pay Advice
  117. disk into drive DF0 (the internal one) and type:
  118.  
  119.                          Copy DF0:s/PayAdvice#? to s:
  120.  
  121. And that's it - No additional files or libraries are required. But don't
  122. forget to copy your saved data files into the PayAdvice drawer!
  123.  
  124.  
  125.  
  126.  
  127.  
  128. LOADING THE PROGRAM
  129. ===================
  130.  
  131. To load the program from Workbench, simply double-click on the Pay Advice
  132. icon.
  133.  
  134. If you prefer using CLI, simply CD to the "PayAdvice:" directory (or make
  135. sure that the program is in your search path) and then type "PayAdvice" at
  136. the CLI prompt. Note, though, that this program isn't self-detaching.
  137.  
  138. Whichever way you load the program, the Pay Advice screen will appear after
  139. a brief pause.
  140.  
  141.  
  142.  
  143.  
  144.  
  145. CREATING A NEW FILE
  146. ===================
  147.  
  148. After loading the program, the first thing you'll need to do is enter some
  149. personal information about yourself. If you press the right mouse button
  150. you'll see a number of pull down menu's appear on the title bar. Move the
  151. mouse pointer up to the "Files" menu and select the "Info" option.
  152.  
  153. You'll see a window appear which is used for both entering and displaying
  154. information about the current file. You should see the following empty
  155. boxes:
  156.  
  157.                 Name
  158.                 Clock
  159.                 Department
  160.                 Employers name & address
  161.  
  162. Just move the mouse pointer over the first box and then press the left
  163. mouse button. You'll see that the cursor has appeared, now type in the
  164. required information and press the return key.
  165.  
  166. Simply repeat this with the other boxes, entering the appropriate details
  167. in each one. Obviously, if you don't use a clocking-on system then you can
  168. just leave that box blank.
  169.  
  170. If you make any mistakes then just re-click in the appropriate box and
  171. change its contents.
  172.  
  173. After you've entered everything, press the "OK" button at the bottom of the
  174. window to return to the main screen.
  175.  
  176. Now, the only other thing left to do is change the category titles shown on
  177. the left-hand side of the main screen, so that they match the details of
  178. your wage packet. To do this, simply select "Edit titles" in the "Prefs"
  179. pull down menu...
  180.  
  181.  
  182.  
  183.  
  184.  
  185. THE MAIN SCREEN
  186. ===============
  187.  
  188. The main screen is split into three distinct sections: Down the left-hand
  189. side of the screen, you'll see the current name of each category of your
  190. wage file, and towards the right, filling most of the screen, is the area
  191. where all your wage details will be displayed.
  192.  
  193. If required, you can easily change the names of each category by selecting
  194. "Edit titles" from the "Prefs" pull down menu at the top of the screen.
  195.  
  196. Finally, you'll see a number of buttons near the bottom of the screen. The
  197. "New entry" button is used to enter new pay slips, the "Edit" button to
  198. edit them, and the arrow buttons move you around your file. Together, these
  199. form the main controls of the program, and are fully explained in the next
  200. three sections.
  201.  
  202. As you enter your wage details into this program, you'll see that it
  203. displays a summary of each wage packet on the screen. The "current" pay
  204. slip, that is to say the one on which all operations will be performed,
  205. will always be highlighted using bold text.
  206.  
  207.  
  208.  
  209.  
  210.  
  211. ENTERING A NEW PAY SLIP
  212. =======================
  213.  
  214. To enter a new pay slip, simply press the "New entry" button at the bottom
  215. of the main screen.
  216.  
  217. A calendar will appear, asking you to enter the date for the new pay slip.
  218. Click on the appropriate on-screen buttons to change the date, and then
  219. press the "OK" button.
  220.  
  221. The edit window will now appear. You'll notice that the name of your first
  222. addition has appeared on the left-hand side.
  223.  
  224. A simplified calculator should now appear on the screen. When ever this
  225. appears it means that the program wants you to enter a number, in this case
  226. the value of that particular category. You can use the calculator with
  227. either the keyboard or the mouse, whichever you prefer.
  228.  
  229. Enter the value of your first addition, and then press return/enter. The
  230. number will now appear in the edit window.
  231.  
  232. One by one, this will be repeated for every addition and deduction to your
  233. wages until everything has been entered, when your net pay will be
  234. displayed. After a short pause you'll return to the main screen, where
  235. you'll see that a summary of the new pay slip has been highlighted.
  236.  
  237.  
  238.  
  239.  
  240.  
  241. MOVING AROUND YOUR PAY SLIP FILE
  242. ================================
  243.  
  244. There are three main methods for moving back-and-forth through your pay
  245. slip file:
  246.  
  247. 1)  Pressing the single-arrow buttons at the bottom of the main screen will
  248.     move you back-and-forth through your file one pay slip at a time, and
  249.     the double-arrow buttons will move you an entire screen at a time.
  250.  
  251. 2)  If you prefer using the keyboard then the left/right cursor keys can
  252.     be used to move you one pay slip at a time, just like pressing the
  253.     single-arrow buttons, and the up/down cursor keys will move a screen
  254.     at a time.
  255.  
  256. 3)  You can use the mouse to click directly on a pay slip on the screen,
  257.     which will perform the equivalent of highlighting that pay slip and
  258.     then pressing the "Edit" button.
  259.  
  260. Additionally, the "Move" pull down menu contains a number of options for
  261. moving around your pay slip file.
  262.  
  263.  
  264.  
  265.  
  266.  
  267. EDITING A PAY SLIP
  268. ==================
  269.  
  270. Sooner or later, whether its because you've made a mistake or whatever,
  271. you're going to want to edit one of your pay slips.
  272.  
  273. To do this, simply highlight the required pay slip using the arrow buttons,
  274. and then press the "Edit" button (or the return key). Alternatively, if the
  275. required pay slip is displayed on the screen, then you can click directly
  276. on it (as detailed in the "Moving about your pay slip file" section).
  277.  
  278. The edit window will re-appear showing all the details for that particular
  279. pay slip.
  280.  
  281. To change the value of one of the categories, all you have to do is move
  282. the mouse pointer over the required category and click the left mouse
  283. button. The appropriate category will then be highlighted, and the
  284. calculator will appear for you to enter a new value.
  285.  
  286. You can change as many numbers as you wish, and then when you've finished
  287. press the "OK" button to keep the changes, or "Cancel" to leave everything
  288. as it was. Either way, you'll be returned to the main screen.
  289.  
  290.  
  291.  
  292.  
  293.  
  294. SAVING YOUR PAY SLIP FILE
  295. =========================
  296.  
  297. Important note: Only the registered version of this program is capable of
  298. saving Pay Advice files. Although it will appear to go through the motions
  299. of saving your file, it won't actually record anything on disk...
  300.  
  301. Obviously, one way or another, you're going to need to save your pay slip
  302. file onto disk. If you hold down the right mouse button, you'll notice a
  303. number of menu's appear on the title bar. Move up to the "Files" menu and
  304. select "Save as".
  305.  
  306. A file requester will appear for you to select the device, directory and
  307. file name to save your file under. Press the "Save" button when you've
  308. selected everything.
  309.  
  310. A window will now appear asking you to enter a password. Because all wage
  311. details are highly confidential, this program saves its files using a
  312. special encryption technique which makes it impossible to load a pay slip
  313. file without first entering the correct password.
  314.  
  315. You can enter anything that you want for the password, up to ten characters
  316. long, but remember that passwords ARE case sensitive and if you forget what
  317. your password is then you've lost your pay slip file.
  318.  
  319. As you type, you'll notice that a * appears on screen for each character of
  320. the password - this is to prevent anybody from reading your password on the
  321. screen while you're typing it. If you're entering a new password then
  322. you'll be asked to type it a second time just to make sure that you didn't
  323. make any typing errors when you entered it.
  324.  
  325. Alternatively, simply pressing the return key without typing anything will
  326. save your file without a password.
  327.  
  328. Your file will (not!) now be saved to disk.
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CUSTOMIZING THE PROGRAM
  335. =======================
  336.  
  337. If you hold down the right mouse button, you'll notice a menu entitled
  338. "Prefs". By selecting one of the options available here, you can change the
  339. way that certain parts of the program work and set it up to your own
  340. personal liking.
  341.  
  342. The three options "Program", "Printer" and "Edit titles" are all fully
  343. explained in the next sections.
  344.  
  345.  
  346.  
  347.  
  348.  
  349. PROGRAM PREFS
  350. =============
  351.  
  352. The preferences window will appear, containing three gadgets:
  353.  
  354.     CALCULATOR  Lets you turn the calculator on/off. If you turn it off,
  355.                 then the cursor will appear in the edit window for you to
  356.                 type numbers from the keyboard. This can be much faster
  357.                 and more convenient if you never intend to use the mouse
  358.                 for operating the calculator.
  359.  
  360.     CALENDAR    Turns the calendar on/off. If you turn it off, then you can
  361.                 choose whether you'd rather type dates using the DD/MM/YY
  362.                 or MM/DD/YY format.
  363.  
  364.     DEFAULT     Most users of this program will probably load the same pay
  365.          FILE   slip file every time they use this program. If you press
  366.                 this button then a file requester will appear for you to
  367.                 choose a file to load automatically whenever you use the
  368.                 program. You'll still need to type the password in, but
  369.                 it'll save you from having to select "Load" and go through
  370.                 the file requester every time.
  371.  
  372. Finally, at the bottom of the window, you'll see the following buttons:
  373.  
  374.     USE         Temporarily keep the current settings.
  375.  
  376.     SAVE        Save the current settings to disk.
  377.  
  378.     CANCEL      Leave everything as it was.
  379.  
  380.  
  381.  
  382.  
  383.  
  384. PRINTER PREFS
  385. =============
  386.  
  387. Unless your printer requires a form feed to be sent after every printed
  388. page then you can safely ignore this section... Otherwise, read on...
  389.  
  390. The preferences window will appear containing the following gadgets, all of
  391. which must be correctly set IN ADDITION TO the standard Workbench printer
  392. preferences.
  393.  
  394.     LINES/PAGE  Click in the box and type the maximum number of lines that
  395.                 your printer can fit on a sheet of paper.
  396.  
  397.     FORM FEED   Some printers, mostly laser printers, need you to send a
  398.                 form feed command after every sheet of paper. If your
  399.                 printer needs a form feed command then turn this on, else
  400.                 leave it off.
  401.  
  402.     RE-DIRECT   If you want to re-direct printer output to a file for some
  403.          OUTPUT reason, then press this button and use the file requester
  404.                 to enter a file name, and then all printer output will be
  405.                 re-directed to that file instead.
  406.  
  407. Again, at the bottom of the window, you'll see the following buttons:
  408.  
  409.     USE         Temporarily keep the current settings.
  410.  
  411.     SAVE        Save the current settings to disk.
  412.  
  413.     CANCEL      Leave everything as it was.
  414.  
  415.  
  416.  
  417.  
  418.  
  419. CHANGING THE USER-DEFINABLE CATEGORY TITLES
  420. ===========================================
  421.  
  422. All wage packets are made up from various additions and deductions to your
  423. earnings, such as basic pay, overtime, and tax. But, despite this, it is
  424. highly unlikely that any two people's wage packets will consist of exactly
  425. the same combination of additions and deductions.
  426.  
  427. There are a total of thirty separate user-definable categories available in
  428. this program, which have been equally split into fifteen additions and
  429. fifteen deductions.
  430.  
  431. These user-definable categories are initially defined with the following
  432. titles:
  433.  
  434.     ADDITIONS
  435.         Basic pay
  436.         Commission
  437.         Overtime
  438.         Special pay
  439.         (The other eleven categories are initially undefined)
  440.  
  441.     DEDUCTIONS
  442.         National insurance
  443.         Pension
  444.         Tax
  445.         Union fees
  446.         Savings deduction
  447.         (The other ten categories are initially undefined)
  448.  
  449. The other four categories, namely "Period ending", "Total gross", "Total
  450. deductions" and "Net pay" are all automatically created and dealt with by
  451. the program, so there's no need to worry about them.
  452.  
  453. If, by some chance, these default titles actually fit the categories on
  454. your wage slip then you can ignore the rest of this section and start using
  455. the program straight away. It's more likely, though, that you'll be needing
  456. to change these titles...
  457.  
  458. Select "Edit titles" from the "Prefs" pull down menu. You'll see a large
  459. window appear in the centre of the screen, containing separate sections for
  460. additions and deductions. Each box in this window represents the title of
  461. an individual category of your wages. The order, from top to bottom, in
  462. which the titles appear in this window is the same as the order in which
  463. they will appear on the main screen.
  464.  
  465. To change a title, move the mouse pointer over the required box and then
  466. press the left mouse button. You'll see that the cursor has appeared in
  467. that box. Use the delete key to erase the current title, and then type in a
  468. new title of your own and press the return key.
  469.  
  470. If you make any mistakes, or if you change your mind, then you can re-click
  471. in any of the boxes and edit their contents.
  472.  
  473. After you've finished, press the "OK" button at the bottom of the window to
  474. keep the new titles, or hit the "Cancel" button to leave them as they were.
  475.  
  476. Either way, you'll return to the main screen, where the amended titles will
  477. be displayed in place of the previous ones.
  478.  
  479.  
  480.  
  481. You should realise, though, that whilst you can edit the titles and change
  482. them around after you've created your file, actually changing the titles
  483. won't have any affect on the contents of the categories themselves. So, for
  484. example, if you changed your titles to move your second addition into
  485. fourth place, and your fourth addition into second place, then only the
  486. titles themselves would change: The actual information entered in your file
  487. as the second addition would remain in that position even though the title
  488. itself had moved.
  489.  
  490. To actually move the information itself you need to use the "Exchange"
  491. function in the "Lines" pull down menu. Select this, and then click on the
  492. two categories that you want to exchange places and press the "OK" button.
  493. All the information entered in those two categories will then swap places
  494. with one another. Please remember, though, that the Exchange function won't
  495. attempt to move any of the category titles themselves, only the actual
  496. information contained within those categories, so the titles will remain as
  497. they were before the function was selected.
  498.  
  499.  
  500.  
  501.  
  502.  
  503. MENU FUNCTIONS
  504. ==============
  505.  
  506. The following pull down menu's are available on the main screen:
  507.  
  508.  
  509. PROGRAM...
  510.  
  511.     ABOUT       Displays information about the program and its authors.
  512.  
  513.     QUIT        Quit the program. Requesters will inform you if you have
  514.                 any unsaved information in your file.
  515.  
  516.  
  517.  
  518. FILES...
  519.  
  520.     LOAD        Load a new file. Use the file requester to select the
  521.                 appropriate file, and then enter the required password.
  522.  
  523.     SAVE        Save the current file automatically using the last file
  524.                 name and password used, thus saving you from having to go
  525.                 through the file requester. Only the registered version
  526.                 of this program can save Pay Advice files!
  527.  
  528.     SAVE AS     Saves the file, as already detailed. Briefly, just use
  529.                 the file requester to enter the file name, and then type
  530.                 in the password. Only the registered version of this
  531.                 program can save Pay Advice files!
  532.  
  533.     SAVE ASCII  Save the current file in ASCII format, so (for example)
  534.                 you can load it into a text editor and re-arrange the
  535.                 layout before printing it. Just choose which categories
  536.                 to save, enter the start & finishing dates, and then use
  537.                 the file requester. Remember, though, that ASCII files
  538.                 aren't password protected and they can't be loaded back
  539.                 into this program. The output will automatically be
  540.                 arranged according to one of three possible formats - see
  541.                 the "Additional notes" section for more information.
  542.  
  543.     DELETE      Use the file requester to erase a file from disk. Remember
  544.                 that you can't undelete a file!
  545.  
  546.     PRINTOUT    Choose which categories you want to print, and then use the
  547.                 calendar to enter the start & finishing dates for the
  548.                 printout. Make sure that your printer is on line before
  549.                 selecting this. The output will automatically be arranged
  550.                 according to one of three possible formats - refer to the
  551.                 "Additional notes" section for more information.
  552.  
  553.     INFO        Displays information about the current file. You can edit
  554.                 these details (if necessary) by clicking in the appropriate
  555.                 boxes.
  556.  
  557.  
  558.  
  559. MOVE...
  560.  
  561.     TOP/FILE    Moves up to the first pay slip of the current file.
  562.  
  563.     BOTTOM/FILE Move down to the last pay slip of the current file.
  564.  
  565.     GOTO %      Type a number into the box, and then you'll be moved to
  566.                 that percentage of the way down the file.
  567.  
  568.  
  569.  
  570. LINES...
  571.  
  572.     INSERT      Inserts a blank pay slip at the current position, moving
  573.                 the current pay slip and everything below it along by one
  574.                 position, and then brings up the edit window for you to
  575.                 enter a new pay slip at that position.
  576.  
  577.     DELETE      Erases the current pay slip, moving everything below it up
  578.                 by one place to fill the gap.
  579.  
  580.     EXCHANGE    This function is mainly intended for use with the "Edit
  581.                 titles" function in the "Prefs" menu. If you've used the
  582.                 "Edit titles" function to re-arrange your wage categories
  583.                 into a different order within the program then you'll find
  584.                 that only the titles themselves have changed, and that the
  585.                 actual information entered in those categories has stayed
  586.                 in the same position as it was before. By selecting this
  587.                 function, you can move the actual wage details in your file
  588.                 from one place to another within the program to make them
  589.                 correspond to the modified titles: Simply click on the two
  590.                 categories that you want to change places and then press
  591.                 the "OK" button. Note, though, that you can't exchange
  592.                 additions with deductions, or vice versa.
  593.  
  594.  
  595.  
  596. OTHER...
  597.  
  598.     SEARCH      Press the appropriate button to choose which category you
  599.                 want to search, and then enter the required value. The
  600.                 program will then search from the current pay slip onwards
  601.                 and, if it finds an entry for your value, will give you the
  602.                 option of either stopping there or continuing the search.
  603.  
  604.     TOTALS      Enter the start & finishing dates, and then the program
  605.                 will calculate and display the totals from between those
  606.                 dates. If you click on the "Print" button, then a copy of
  607.                 the totals window will be sent to the printer.
  608.  
  609.     DATE ORDER  Re-arrange the current file into date order. Be warned,
  610.                 though, if you are working with a large file then this
  611.                 might take a couple of minutes.
  612.  
  613.  
  614.  
  615. PREFS...
  616.  
  617.     PROGRAM     Edit the program preferences, as already detailed.
  618.  
  619.     PRINTER     Edit the printer preferences, as already detailed.
  620.  
  621.     EDIT TITLES Change the category titles, as already detailed.
  622.  
  623.  
  624.  
  625.  
  626.  
  627. ADDITIONAL NOTES
  628. ================
  629.  
  630. This program makes the assumption that time started on 1st January 1950,
  631. and that it runs out on 31st December 2049. Somehow I can't see this
  632. causing any problems because hardly anybody will want to catalogue any pay
  633. slips that they might have lying around from before 1950, and, frankly, by
  634. the year 2049 we'll all have upgraded to something a little more powerful
  635. than the Amiga...
  636.  
  637.  
  638. This program is unable to handle numbers any larger than nine characters in
  639. length. To be honest, I don't think that anybody who has numbers longer
  640. than nine characters on their pay slip will be actively involved in using
  641. PD & shareware programs anyway, so I can't imagine this being a problem!
  642.  
  643.  
  644. If you accidentally tell the program that you want to enter a new pay slip,
  645. when in actual fact you didn't want to, then there is a way of cancelling
  646. the input sequence. If you've got the calculator turned on (which it will
  647. be by default) then all you have to do is hit the close gadget. If you've
  648. turned the calculator off, then when prompted to enter a number you should
  649. type "C" (without the quotes!) and press the return key. Either way, the
  650. operation will be cancelled.
  651.  
  652.  
  653. A word about memory: This program requires a large chunk of unfragmented
  654. memory in order to work correctly. It'll work OK on machines with 1 meg or
  655. more, so if you have less than this then I'd recommend booting your
  656. computer and running this program without loading anything else in between.
  657. This should cure most problems.
  658.  
  659.  
  660. File names... It is officially recommended that you start a new pay slip
  661. file for each financial year, and that you save your files with names such
  662. as "FredBloggs1994" for your 1994 records while working for Fred Bloggs (or
  663. whatever). If you do insist on keeping inordinately long files, then this
  664. program will handle files up to 250 pay slips long (if you get paid weekly,
  665. then that's about FIVE YEARS worth!)
  666.  
  667.  
  668. File compatibility: Sadly, it is no longer possible to keep this program
  669. compatible with files created or saved using V1.27 of this program, but it
  670. still works fine with files from V2.00 onwards. If you still need to use
  671. files created on V1.27 of this program, then you'll need to convert them
  672. into V2.00/V3.00 format. To do this, you'll need to have either the PD or
  673. registered version of Pay Advice Analyser V3.00: Load your V1.27 file into
  674. this and it'll automatically convert it into V2.00/V3.00 format, and then
  675. all you have to do is save it again. You'll then be able to load it into
  676. this program without any problems.
  677.  
  678.  
  679. The program will automatically attempt to arrange printouts and ASCII files
  680. according to one of the following three formats in this order:
  681.  
  682. 1)  If you select a total of ten categories or less (including categories
  683.     such as "Net pay") then your file will be printed with each pay slip
  684.     squeezed onto a single line - handy if you want to fit a full year
  685.     onto a single A4 sheet.
  686.  
  687. 2)  Providing you don't select more than nine additions and more than
  688.     nine deductions (if it's selected then the total addition/deduction
  689.     categories will be counted as one of the nine) then the program will
  690.     attempt to fit each pay slip onto two printed lines, putting additions
  691.     on the first line and deductions on the second, with a blank line to
  692.     separate each pay slip.
  693.  
  694. 3)  Failing the above, it will revert to the V4.0 method of printing the
  695.     pay slips in the same vertical format as they appear on the screen,
  696.     fitting six pay slips across the width of each page.
  697.  
  698. If the program uses option 1 or 2 then numbers longer than seven characters
  699. will be printed with the left-most digits removed (so "123456.78" would be
  700. printed as "<3456.78")
  701.  
  702.  
  703. Remember that you can add new categories to the program at any time by
  704. using the "Edit titles" function in the "Prefs" menu, so if a new addition
  705. or deduction appears on your pay slip part way through the financial year
  706. then all you have to do is use this to add the extra categories! Also, when
  707. you edit pay slips, you'll find that you can click in unused categories and
  708. put numbers in them, so if you get an extra addition/deduction but don't
  709. want to create a category for it then you can still include it in your
  710. file...
  711.  
  712.  
  713.  
  714.  
  715.  
  716. THE TRADITIONAL JOKES
  717. =====================
  718.  
  719. Yes, that's right, it's time for more of my favourite jokes...
  720.  
  721.  
  722.     1)  Why did the vicar walk on his hands?
  723.         Because it was Palm Sunday!
  724.  
  725.  
  726.     2)  How many computer programmers does it take to change a light bulb?
  727.         None, because it's a hardware problem!
  728.  
  729.  
  730.     3)  Why don't cats shave?
  731.         Because 9 out of 10 owners said their cats prefer whiskers!
  732.  
  733.  
  734.     4)  What has one wheel and flies?
  735.         A wheelbarrow full of horse manure!
  736.  
  737.  
  738.     5)  How do you stop a rooster from crowing on Monday morning?
  739.         Eat it for Sunday dinner!
  740.  
  741.  
  742. Ha ha ha ha ha... Ahem...
  743.  
  744. Er, perhaps that's enough jokes for now...
  745.  
  746.  
  747.  
  748.  
  749.  
  750. VERSION HISTORY
  751. ===============
  752.  
  753. V1.27   Released 14th January 1993
  754.  
  755.         The first public release of this program. After much consultation
  756.         with Andy Eskelson, the program has a half-decent user interface,
  757.         and, more importantly, it actually works...
  758.  
  759. V2.00   Released 19th July 1993
  760.  
  761.         * A complete re-write of the user interface.
  762.  
  763.         * Re-organised the pull down menu's into a sensible order.
  764.  
  765.         * Added keyboard short-cuts for commonly used menu items.
  766.  
  767.         * Completely re-wrote the LOAD and SAVE routines to incorporate
  768.           complete file encryption, instead of just partial encryption
  769.           as used in previous versions.
  770.  
  771.         * Added a calendar, pre-set from the system clock, for entering
  772.           dates into the program.
  773.  
  774.         * Incorporated a simple calculator for entering numbers.
  775.  
  776.         * Improved number handling - Decimal places are automatically
  777.           checked, and all numbers are now right-justified.
  778.  
  779.         * Wrote a "SAVE AS ASCII" function, enabling you to load your
  780.           Pay Advice files into a word processor or text editor to
  781.           re-arrange the layout before printing them.
  782.  
  783.         * Modified the screen display, so now the program uses the entire
  784.           screen to display your file instead of just the bottom few
  785.           lines.
  786.  
  787.         * Added a "DELETE FILE" function to the pull down menu's.
  788.  
  789.         * Modified the colour palette: You can actually read the file
  790.           requesters now!
  791.  
  792.         * The program will now warn you if you try to quit when there's
  793.           unsaved information in the current file.
  794.  
  795.         * Added some new printer preferences routines and completely
  796.           re-wrote the printout function.
  797.  
  798.         * Wrote a way, through the calculator, to cancel the input
  799.           sequence for entering a new pay slip (press "C" twice)
  800.  
  801.         * Improved the screen update and button-handling routines.
  802.  
  803.         * Plus numerous bug removals (too many to list!) and more...
  804.  
  805. V2.10   Released 5th August 1993 (EXCLUSIVE TO REGISTERED USERS)
  806.  
  807.         * It turned out that my new printout routines had a slight bug
  808.           in them which affected the last page of a printout. Corrected.
  809.  
  810.         * Added an ICONIFY routine.
  811.  
  812.         * Plus a few minor enhancements and modifications here and
  813.           there...
  814.  
  815. V3.00   Released 11th October 1993
  816.  
  817.         * Er, don't know how to say this, but the "DELETE FILE" function
  818.           never actually worked! Corrected this, plus a number of other
  819.           bugs.
  820.  
  821.         * Looks like there was a problem with the "SAVE AS ASCII" routines
  822.           used in V2.10 - the columns of numbers didn't line up properly!
  823.           Corrected this as well.
  824.  
  825.         * Incorporated some program preferences routines...
  826.  
  827.         * User now has the option of whether or not to use the calculator.
  828.  
  829.         * The calendar can now be disabled, and if so, the user can choose
  830.           whether to type dates using the DD/MM/YY or MM/DD/YY format.
  831.  
  832.         * Added an option to automatically load a Pay Advice file by
  833.           default.
  834.  
  835.         * Drastically improved the screen update speed.
  836.  
  837.         * Completely re-wrote the "ARRANGE INTO DATE ORDER" function, so
  838.           now it'll re-arrange any size file in a couple of minutes or
  839.           so, instead of taking up to ten times longer than this! Also,
  840.           this routine will now automatically remove any blank lines from
  841.           the current file.
  842.  
  843.         * Added some error handling routines - Now, if something goes
  844.           wrong, the program will tell you what happened instead of just
  845.           quitting with a meaningless error code.
  846.  
  847.         * Wrote some nice single-button requesters, so you don't get any
  848.           more daft requesters appearing with two "Cancel" buttons beside
  849.           one another.
  850.  
  851.         * When saving files, when asked to enter a password you can now
  852.           press return without typing anything to keep the last password
  853.           that you entered.
  854.  
  855.         * If you've customized the file layout, the program will no longer
  856.           ask you to enter a number for any category which doesn't have a
  857.           name (you can still put numbers in these categories by editing
  858.           the pay slip in the usual manner)
  859.  
  860.         * File loading and saving is now directed towards the AmigaDos path
  861.           PayAdvice: instead of the program guessing (often wrongly!) what
  862.           the current device and directory are likely to be.
  863.  
  864.         * A minor cosmetic change: Designed a nice, 2.0-style icon to
  865.           replace the old Pay Advice program icon.
  866.  
  867.         * Plus more...
  868.  
  869. V4.00   Released 24th December 1993
  870.  
  871.         * A complete re-design of the GUI... The program now conforms far
  872.           more closely to the WB2-standard for user interfaces...
  873.  
  874.         * The program now supports ten user-definable categories instead
  875.           of just six.
  876.  
  877.         * Converted the Pay Advice doc file into AmigaGuide format.
  878.  
  879.         * Incorporated a standard WB2 AmigaDos version string into the
  880.           program.
  881.  
  882.         * Changed the main Pay Advice screen into a backdrop window, so
  883.           now you can't accidentally lose requesters and such behind the
  884.           main screen...
  885.  
  886.         * Modified the error handling routines - Now, if something goes
  887.           wrong, the program will give you the option of attempting to
  888.           save the current file before quitting.
  889.  
  890.         * To keep memory requirements down to a minimum, the maximum
  891.           number of pay slips allowed in each file has been lowered from
  892.           five hundred to two hundred and fifty (the extra categories
  893.           mean that you need more memory to store each individual pay
  894.           slip than in earlier versions)
  895.  
  896.         * Modified the keyboard controls for moving through a pay slip
  897.           file: The left/right cursor keys now move you one line at a
  898.           time, and the up/down keys move you a screen at a time.
  899.  
  900.         * Due to technical reasons, this program is no longer compatible
  901.           with files created/saved using V1.27 of this program - but it
  902.           still works fine with files saved from V2.00 onwards.
  903.  
  904.         * Completely re-wrote the "SAVE AS ASCII" function, and removed the
  905.           "With grid" and "Without grid" options. You can now choose which
  906.           categories you want to save, and can also select the start and
  907.           finishing dates for the save...
  908.  
  909.         * Unless your printer requires a form feed after every printed
  910.           page, then you can now completely ignore the section about
  911.           setting up the programs internal printer preferences.
  912.  
  913.         * The program now displays the current file name on the title bar.
  914.  
  915.         * Added a "Printout" option to the "DISPLAY TOTALS" function.
  916.  
  917.         * Renamed the "SAVE" function to "SAVE AS", and added a new "SAVE"
  918.           menu function which lets you save the current file automatically
  919.           using the last file name and password used.
  920.  
  921.         * When editing a pay slip with the calculator turned on, the
  922.           program will no longer remove the value from any category that
  923.           you select in the edit window - Instead the number will now
  924.           stay where it is and the calculator will appear with a blank
  925.           display.
  926.  
  927.         * Removed the "Do you wish to modify the file format" requester
  928.           from the "Create a new file" routine, and replaced it with an
  929.           "EDIT TITLES" function in the "Prefs" menu. You can now change
  930.           the titles any time you want, and not just exclusively when
  931.           you're creating a new file...
  932.  
  933.         * Added an "EXCHANGE" function to the "Lines" menu, which lets
  934.           you swap information between categories, mainly for use with
  935.           the "Edit titles" function.
  936.  
  937.         * When creating a file, or modifying the user-definable category
  938.           titles, the program will no longer automatically erase the
  939.           current contents of a box when you click in it to edit its
  940.           contents.
  941.  
  942.         * Added a "Cancel" button to the "SEARCH FILE" function.
  943.  
  944.         * You can now cancel the input sequence for entering a new pay
  945.           slip even if you're not using the calculator: Type "C" (without
  946.           the quotes!) and press return when prompted to enter a number.
  947.  
  948.         * It appears that the program would let you enter daft numbers
  949.           like "12.34.56" and actually accept them! Corrected this.
  950.  
  951.         * Centred all the "Details for period ending..." titles in the
  952.           edit and totals windows.
  953.  
  954.         * Modified the "INSERT LINE" function so that it'll automatically
  955.           bring up the edit window for you to enter a new pay slip.
  956.  
  957.         * Drastically reduced the delay by which the edit window remains
  958.           on screen after entering a new pay slip.
  959.  
  960.         * The "SEARCH FILE" function no longer stops at the first entry
  961.           that it finds - A requester will now appear telling you which
  962.           pay slip contains the required value and asking whether or not
  963.           you want to continue the search.
  964.  
  965.         * Modified the "ICONIFY" routine to include a password option.
  966.  
  967.         * The "PRINTOUT" routines will now let you specify exactly which
  968.           categories you want to print, and now includes an option to print
  969.           the totals for the selected categories...
  970.  
  971.         * When you click on an entry to modify it when editing a pay slip,
  972.           simply pressing enter without typing a new number will no longer
  973.           clear the current value of that category.
  974.  
  975.         * All main buttons in the program will now respond to keyboard
  976.           short-cuts, instead of just those on requesters...
  977.  
  978.         * The Pay Advice preference files are now loaded and saved to
  979.           AmigaDos path "s:" instead of "SYS:s"
  980.  
  981.         * Plus other minor enhancements...
  982.  
  983. V4.2    Released 20th October 1994
  984.  
  985.         * Incorporated further refinements and improvements to produce a
  986.           more consistent user interface.
  987.  
  988.         * The program now supports thirty user-definable wage categories,
  989.           equally divided into fifteen additions and fifteen deductions.
  990.  
  991.         * Pay Advice now runs on an interlaced screen (this was the only
  992.           way to make enough room to display the extra categories!)
  993.  
  994.         * The "PRINTOUT" and "SAVE AS ASCII" routines now automatically
  995.           attempt to arrange output according to one of three possible
  996.           formats (see the "Additional notes" section for more details!)
  997.  
  998.         * Removed all the duff-looking "Please wait..." windows, and made
  999.           it so that the program instead uses a proper 2.0 busy pointer to
  1000.           indicate when it's busy.
  1001.  
  1002.         * Got rid of the roman numerals from the Pay Advice title...
  1003.  
  1004.         * Passwords are no longer displayed on the screen - The program
  1005.           now uses the traditional method of displaying *'s for every
  1006.           character that is typed. This means that if you're entering a
  1007.           new password then you'll be asked to enter it a second time to
  1008.           make sure you didn't make any mistakes while typing it!
  1009.  
  1010.         * The current file name is now displayed at the top of the main
  1011.           screen, instead of on the title bar.
  1012.  
  1013.         * Improved the colour palette, so now you don't have to squint to
  1014.           read the old grey-on-grey pull down menu's any more!
  1015.  
  1016.         * Removed the "Do you wish to create/load a file" requester which
  1017.           always used to appear when the program was loaded, so now when
  1018.           you load Pay Advice it'll take you directly to the main screen.
  1019.  
  1020.         * The details that you would normally enter when creating a new
  1021.           file (your name, department, and so forth) can now be entered
  1022.           or changed using the "INFO" function in the "Files" menu.
  1023.  
  1024.         * When saving files, if you just press the return key (without
  1025.           typing anything) when asked for the password then your file will
  1026.           now be saved without a password. Use this wisely...
  1027.  
  1028.         * Re-designed the calculator and put it in a normal window with a
  1029.           drag bar and a close gadget, enabling you to move it anywhere
  1030.           you want on screen. Pressing the close gadget now cancels the
  1031.           input sequence.
  1032.  
  1033.         * All windows (except the calculator!) are now opened as backdrop
  1034.           windows...
  1035.  
  1036.         * Removed the "ICONIFY" function - I honestly don't think anybody
  1037.           ever used it!
  1038.  
  1039.         * The "Re-direct output" option now re-directs printouts from the
  1040.           totals window as well as the main printout function! Also, it
  1041.           now appends the output to the end of the existing file instead
  1042.           of overwriting it!
  1043.  
  1044.         * Menu items now "ghost" themselves to indicate when they can and
  1045.           can't be used. Also, the pull down menu's will only appear on the
  1046.           main screen itself now!
  1047.  
  1048.         * The "DISPLAY TOTALS" function now correctly ignores any unused
  1049.           categories.
  1050.  
  1051.         * Added a "Cancel" button to the category selection window in the
  1052.           "SAVE AS ASCII" and "PRINTOUT" routines. Also, unused categories
  1053.           are now switched off by default.
  1054.  
  1055.         * If you "SAVE AS ASCII" to an existing file then you'll now be
  1056.           asked whether to append or overwrite it.
  1057.  
  1058.         * Added a "NEW ENTRY" button to the main screen for entering new
  1059.           pay slips.
  1060.  
  1061.         * Removed the "Gross pay" and "Deductions" titles from the edit
  1062.           window - they looked too much like category names and weren't
  1063.           really needed anyway!
  1064.  
  1065.         * If you've turned the calendar off then you're no longer forced to
  1066.           uses slashes to seperate the numbers, any non-numeric character
  1067.           will do.
  1068.  
  1069.         * The program no longer crashes if you try to save your file on a
  1070.           write-protected disk!
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076. DISCLAIMER
  1077. ==========
  1078.  
  1079. This software is supplied "AS IS" without any warranty of any kind, either
  1080. expressed or implied, including, but not limited to, the implied warranties
  1081. of merchantability and fitness for a particular purpose. The entire risk as
  1082. to the results and performance of this software is assumed by the user.
  1083. Should the software prove defective, the user (and not the author or
  1084. anybody associated therewith) assume the entire cost of all necessary
  1085. servicing, repair or correction. Further, the author does not warrant,
  1086. guarantee or make any representations regarding the use of, or the results
  1087. of the use of, this software in terms of correctness, accuracy,
  1088. reliability, currentness, or otherwise; and you rely on this software and
  1089. the results entirely at your own risk. In no event will the author be
  1090. liable for direct, indirect, incidental or consequential damages resulting
  1091. from the use of this software even if advised of the possibility of such
  1092. damages.
  1093.  
  1094. The author reserves the right to make changes to this software at any time
  1095. without obligation to notify any person or entity of such revisions or
  1096. changes.
  1097.  
  1098. This program, and all associated software, files, programs and text, is the
  1099. exclusive copyright of Richard Smedley 1992, 1993, 1994, All Rights
  1100. Reserved. Permission is hereby granted for this "save disabled" version of
  1101. this software to be freely distributed in its entire form only, providing
  1102. all files remain intact and unmodified.
  1103.  
  1104. This disclaimer shall supersede any verbal or written statement to the
  1105. contrary.
  1106.  
  1107. Your use of this software indicates your acceptance of this disclaimer.
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113. FINAL WORDS
  1114. ===========
  1115.  
  1116. Well, that seems to have covered everything.
  1117.  
  1118. It just remains for me to say "Hey take it easy"
  1119.  
  1120. Auf Wiedersehen,
  1121.  
  1122. Richard Smedley
  1123.